package com.cordys.bpm.event;
/**
 * Use this contract to execute your custom logic when a process event occurs for a process in Process Platform. 
 * Configure the FQN of the class implementing this interface in the process properties of the process model.
 * You can provide the implementation for the events that occur within a process instance life cycle.
 * 
 */
public interface ProcessEventListener
{
	/**
     * This method is invoked when a process instance is created.
     */
    void onProcessStart(ProcessInformation processInfo);
    
    /**
     * This method is invoked when the process instance is complete.
     */
    void onProcessComplete(ProcessInformation processInfo);
   
    /**
     * This method is invoked when an activity instance goes to an error state during its execution.
     */
    void onProcessAbort(ProcessInformation processInfo);
    
    /**
     * This method is invoked when an activity instance of a process is created.
     */
    void onActivityStart(ActivityInformation activityInfo);
    
    /**
     * This method is invoked when an activity instance of a process is complete.
     */
    void onActivityComplete(ActivityInformation activityInfo);
    
    /**
     * This method is invoked when an activity instance results in an error during execution.
     */
    void onActivityAbort(ActivityInformation activityInfo);
}

package com.cordys.bpm.event;

import javax.transaction.SystemException;
import javax.transaction.Transaction;
import org.w3c.dom.Element;
import com.eibus.localization.exception.custom.LocalizableIllegalStateException;
/**
 * This contract provides the APIs that are available to the event listeners as parameters.
 */
public interface ProcessInformation
{
    /**
     * This method returns the ID of the current instance.
     */
    String getInstanceID();
 
    /**
     * This method returns the parent instance from where the current instance is created.
     */
    String getParentID();
 
    /**
     * This method returns the root instance ID from where the current instance is created.
     */
    String getRootID();
 
    /**
     * This method returns the process model ID from where the current instance is created.
     */
    String getProcessModelID();
 
    /**
     * This method returns the organization DN under which the current instance is created.
     */
    String getOrganization();
 
    /**
     * This method returns the process model name whose instance is created.
     */
    String getProcessModelName();
 
    /**
     * This method returns the status of the current instance.
     */
    String getStatus();
 
    /**
     * This method returns the user DN of the user who last worked on the current instance.
     */
    String getCurrentOwner();
 
    /**
     * This method returns the start time of the current instance in milliseconds.
     */
    long getProcessStartTime();
 
    /**
     * This method returns the last updated time of the current instance in milliseconds.
     */
    long getProcessLastUpdatedTime();
 
    /**
     * This method returns the message map element of the current instance, which is updated with the input and output message of each activity in the process model.
     */
    Element getMessageMap();
 
    /**
     * This method returns the error text of the current instance if an error occurs.
     */
    String getErrorText();
}
 
package com.cordys.bpm.event;
/**
 * This contract provides the APIs that are available to the event listeners as parameters.
 */
public interface ActivityInformation
{
	/**
     * This method returns the activity ID.
     */
    String getActivityID();
    /**
     * This method returns the iteration count of the activity execution.
     */
    String getIterationCount();
    /**
     * This method returns true if the current activity execution is replaced.
     */
    boolean isReplaced();
    /**
     * This method returns the correlation ID of the created activity. If the activity is of the type task or Web service, the method returns the task or message ID.
     * If the activity type is a sub-process or sub-case, then the method returns instance ID of the sub-process or sub-case. 
     */
    String getCorrelationID();
    /**
     * This method returns the current activity name.
     */
    String getActivityName();
    /**
     * This method returns the current activity type.
     */
    String getActivityType();
    /**
     * This method returns the status of the current activity.
     */
    String getActivityStatus();
    /**
     * This method returns the start time of the current activity in milliseconds.
     */
    long getActivityStartTime();
    /**
     * This method returns the last updated time of the current activity in milliseconds. This value is available only after the activity is complete.
     */
    long getActivityEndTime();
    /**
     * This method returns the execution userDN of the current activity. This value is available only after the activity is complete.
     */
    String getExecutedBy();
    /**
     * This method returns the {{IProcessInformation}} object.
     */
    ProcessInformation getProcessInfo();
}